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Abstract 

This  iiocuiiwnt  forms  the  instnictioit  manual  for  the  compartment  editor  of  the  fire 
management  training  aid,  called  FIREMAID. 

FIREMAID  is  a  graphics  based,  interactive  ship  fire  fighting  simulator,  xohich  can  be 
based  on  a  range  of  naval  ships. 

The  compartment  editor  enables  the  creation  or  alteration  of  ship  description  files  ns 
well  as  the  development  of  scenarios  for  the  fire  simulation. 
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FIREMAID:  Compartment  Editor 


1.  Introduction 

This  mnnunl  describes  the  proi;rnm  COMP-EDIT.  It  wns  written  to  ennble  nn 
instructor  to  define  and  modifv  ship  compartment  details  and  set  up  fire  incident 
scenarios  on  FIREMAID  data  disks  1 1 1.  The  COMP-EDIT  program  is  included  on 
the  COMPARTMENT  EDITOR  disk. 

The  file  structure  of  a  FIREMAID  data  disk  is  described  to  allow  new  ship  data 
disks  to  be  set  up  or  images  to  be  added  to  an  existing  ship  data  disk  Some 
knowledge  of  AMIGAEKDS,  the  Amiga  computer  s  operating  system,  and  familiarity 
with  a  text  editor  is  necessary  to  create  a  new  data  disk. 

The  examples  used  in  this  manual  will  refer  to  the  data  disk  set  up  for  an  FFG-7 
frigate. 


2.  Data  Disk  Structure 

The  following  section  describes  the  files  contained  on  the  FIREMAID  data  disks 
which  contain  the  description  of  the  ship  and  a  number  of  possible  fire  incidents. 

The  logical  label  [2]  for  all  ship  data  disks  is  SI  IIPD.ATA  ’  Both  the  FIREMAID 
program  and  COMP-EDIT  refer  to  the  data  disk  by  this  logical  label  when  accessing 
the  data  files. 

Two  directories,  /'/cs  and  ftUitn,  are  contained  on  the  data  disk  . 

The  directory  pics  contains  the  screen  image  files.  These  images  are  digitised 
images  of  the  ship's  damage  ctmtrol  diagrams  and  are  used  to  set  up  the  ship 
description.  Although  it  is  not  strictly  necessary,  it  is  recommended  that  the  images 
be  stored  in  this  directory.  The  shift.ftlan  file  in  the  stfntti  directory  determines  the 
image  locations  by  also  including  the  data  path  on  the  SHIPDATA  disk  through  the 
pics  directory. 


The  ship  imnj*os  must  exist  before  the  COMP-EDIT  program  is  used.  Some  of  the 
digitised  images  used  to  describe  an  FFG-7  are  shown  in  Figure  1 .  The  top  four  decks 
of  an  FFG-7  ha\’e  been  split  intti  3  images  per  deck  for  the  image  arrav.  The  images 
can  be  obtained  from  digitising  sectiims  of  the  damage  control  boards  or  bv  drawing 
the  images,  using  computer  packages  such  as  DELUXEPAINT  |3]  or  DIGIVIEW  14|. 

It  is  recommended  that  each  image  overlaps  its  neighbour  (on  the  same  deck)  so  as  to 
include  a  major  frame  (or  bulkhead)  which  is  common  to  the  neighbouring  image.  All 
other  o\’crlapping  information  will  be  disregarded.  Thus  each  image  will  have 
unique  compartments. 

It  is  recommended  that  each  image  have  no  more  than  30  compartments,  otherwise 
information  displayed  by  the  FIREMAID  program  may  become  too  cluttered  to 
clearlv  comprehend. 

The  Si/rtfrt  directorv  contains  the  follivwing  files: 
ciiifip.dat 

i1csc.)i  (;;=/.  2,  3  . f 

Sciiri-s 

tloodiii^.iiiftyniiation 

fircstnrt.ihn 

The  si'cri'.s  file,  the  tlc<c.n  tiles  and  the  tiir>tiirt.iltit  file  are  the  output  files  of  COMP- 
EDIT's  "New  Incident"  optitm.  The  .mitcs  file  is  used  b\'  the  FIRE.MAID  program  for 
performance  ev  aluation  anel  storage  The  tiles  contain  a  description  of  each 
incident  stored  in  the  file.  The  tlootlin^.iiitoniintion  file  contains  data 

necessary  to  calculate  stabilitv  \  aliies  tor  the  ship  concerneii.  The  data  is  stored 
numericalK'  in  the  following  format  (e  g.  for  an  FFG-7)  : 


; 

Density  of  liquid  (ie  water) 

3900 

Ship  mass  (tons) 

12 

Width  of  ship  at  deck  le\  el  (metres) 

13 

Total  height  ot  ship  (metres) 

136 

Total  lenght  of  ship  (metres) 

45 

■Angle  of  hull  to  horizontal  (degrees) 

4 

Height  of  centre  of  mass  (metres) 

7.5 

Height  of  deck  (metres) 

The  file  ^liip.phiii  must  exist  bektre  using  COMP-EDIT.  It  contains  information  on 
the  screen  image  files  used  by  COMP-EDIT.  The  number  of  decks,  the  number  of 
images  per  deck  and  a  list  of  image  names  are  stored  in  tiliip.phiii.  An  example  of  the 
file  format  of  ^liip.plnii  for  an  FFG-7  is  as  follows: 


6 


02 LEVEL 


1 1 02 LEVEL 


2  02 LEVEL 


3 


01  LEVEL  4  01  LEVEL  5  01  LEVEL 


Fiifurc  1;  The  FIREMAID  suite  of  firo^niiiis  use  liis^itiseii  images  ofu  slilfi  s  ihuun^e  eoiitrol 
I’onnis.  This  figure  shows  the  to)’  four  hecks  of  a  FFC-7.  'which  ore  the  first  tu'cli'e  inin;^es 
listeh  ill  the  ship.filiin  file. 


3 

4 

"fliifHlata:pics/()2level-bnck“ 

“fhipdiiln:pici/02li‘i>el-iiiidtile" 

"f!iipdata:pics/02lcvei-fom<nrd" 

''>liipdiitit:pic>/01lcvfl-l>ink" 


"<liipdntii:pic>/2i!liit-foni'nrd" 

“fliipdatn:picf/liold-back" 

"flupd(it(t:piLy/hold-niiddli’'' 

":^hipdnta:picf/liold-fonimrd" 

"0  2lcx’cr' 

"O  7  level" 

"niiiiii  deck" 

"2  deck" 

3  deck  " 

4  deck 
"5  deck" 

Tor  <Tn  FFCi-7,  with  three  imn^^es  per  lieck  .mil  se\  en  liecks,  .1  lot.il  of  twentv-one 
imnj’cs  dosicrihe  the  entire  ;<liip.  The  "home  lieck  in  this  c.ise  h.is  been  cliosen  .is  tlie 
fourth  deck  down  in  the  ini.i);e  .irr.iy  (see  Fi);.  1 ),  or  2-deck,  Die  centr.il  im.ige  of  the 
"liomc"  deck  (or  the  rif’ht-of-centre  ini.ige  for  .in  e\  en  number  of  im.iges  per  deck)  is 
displ.iyed  re>;ul.irly  durinj;  the  execution  of  COMI’-FDIT,  .is  .i  reference  im.ine  for  the 
image  array.  Tims  the  home  deck  should  be  chosen  for  quickest  access  to  all  other 
images  in  the  array.  The  image  file  names  (including  logical  data  paths)  are  then 
listed  so  that  the  first  image  depicts  the  aft  section  of  the  topmost  deck  and  the  last 
image  depicts  the  forward  section  of  the  lowest  deck.  This  produces  a  sequence 
similar  that  shown  in  Figure  1.  The  last  section  of  ship  plan  contains  the  name  of  each 
deck  as  eerbali.sed  during  execution  ot  the  FlKEMAIl)  program 

The  file  conip.dnt  contains  the  bulk  of  the  data  describing  the  ship  inrliuling  all 
bulkheacfs,  compartments  and  associated  information  It  i-.  extensiveh'  modified 
during  the  operation  of  the  COMr-EDl  F  program. 

One  last  file,  called  >tiitu>.>cni,  must  exist  on  the  >liipdiitii  ilisk.  This  is  .i  picture  file 
used  bv  the  FIKEMAID  program  but  is  not  used  bv  the  L'OMI’-EITIT  program. 


Number  of  decks 
.Number  of  images  per  deck 
Home  deck 


List  of  image  files 


.Name  oi  each  deck 


3.  Editor  Instructions 

A  ship  is  best  defined  in  the  following  order.  F'irstlv,  major  bulkheads  or  frames  are 
defined  for  each  ship  image.  Secondlv.  compartment  locations  (and  contents)  are  to 
be  defined  with  reference  to  these  frames.  Fhe  compartments  must  then  be  linked  to 
their  neighbouring  compartments,  so  that,  tinallv,  fire  incidents  can  be  set  up  for  use 
in  the  FIKEMAID  program 
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To  define  the  vessel  in  this  manner,  three  menu  titles  are  provided  -  FRAMES, 
ROOMS  and  CONTROL.  The  menu  heading  will  appear  when  the  right  mouse 
button  is  pressed.  These  menus  and  their  options  will  be  described  in  the  following 
sections. 

For  the  sake  of  brevity  in  these  instructions  we  will  define  the  following: 

Click  "object''  -  This  will  mean  position  the  mouse  pointer  over  the  "object"  then 
press  and  release  the  left  mouse  button 

Select  "item"  from  the  menu  -  Move  the  mouse  pointer  to  the  title  bar  at  the  top  of  the 
screen  (where  "Compartment  Editor"  is  printed),  and  press  and  hold  the  right  mouse 
button.  While  still  holding  the  right  mouse  button  down,  move  across  to  highlight 
the  desired  menu  title,  then  descend  to  the  menu  "item"  required  (which  will 
highlight  when  the  mouse  is  over  it)  and  release  the  mouse  button  i>ver  voiir 
selection, 

Kei/hoimi  entni  -  Remember  to  press  the  RETURN  kev  after  all  kevboard  inputs  - 
where  the  cursor  remains  on  the  same  line,  to  C(»mplete  vour  entrv. 

Imnge  nmnipnlntion  -  To  move  off  the  "home"  ship  image  and  onto  another  image, 
press  the  arrow  kevs  (up,  down,  left,  right)  on  the  kevboard. 

To  use  the  COMP-EDIT  program,  turn  on  the  computer  and  insert  the 
COMPARTMENT  EDITOR  disk  into  the  disk  drive 
It  will  take  the  program  a  mini>te  or  so  to  load.  When  fully  loaded  the  program  will 
show  a  screen  which  will  ask  you  to  insert  a  data  disk.  Once  the  disk  drive  light  is 
off,  eject  the  compartment  editor  disk  from  the  disk  drive,  and  inserf  the  data  disk 
which  contains  all  the  information  about  the  ship.  (For  example,  for  the  FFG-7  this  is 
labeled  'FFG  DATA"). 

Click  the  left  mouse  button  once  (as  instructed)  and  the  pri'gram  will  start.  An 
image  of  a  deck  section  will  appear,  with  the  instructii>n  to  "Make  a  selection  from  the 
menu ". 


4,  Frames 

Before  any  compartments  can  be  created  on  the  ship,  the  key  bulkheads,  or  frames, 
must  be  defined  as  reference  points.  The  program  uses  this  bulkhead  information  to 
determine  neighbouring  compartments  bt*th  horizon  ta  1 1  v  through  bulkheads  and 
vertically  between  decks.  Two  adjacent  images  sharing  a  common  bulkhead  should 
both  have  the  bulkhead  defined,  as  seen  in  Figure  2.  Adjacent  images  without 
common  bulkheads  are  considered  tt>  have  no  neighbours  on  the  adjacent  image.  If 
no  common  bulkheads  are  defined  between  decks,  the  procedure  to  link 
compartments  (section  6.2)  will  take  slightly  longer,  but  vertical  neighbours  will  be 
linked. 

The  bulkheads  are  defined  using  the  FRAMES  menu.  The  following  subsections 
describe  the  functions  of  the  FRAMES  menu. 
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common  bulkhead 


Fif’iirc  2:  Aitjiicciit  iriiiiiiv  n  t  i<iiinii<ii  hnlklirdtl  lo  hi‘  dchuai. 


4.1  Add  Frame 

Select  "Add  Frame  "  from  the  menu 

To  add  a  frame,  tvpe  in  tlie  image  number  to  which  the  frame  is  to  he  added  (where 
image  numbers  increase  from  aft  to  forward,  and  down  decks,  as  seeii  m  Ihg  1 ).  The 
image  will  then  be  shown  on  the  screen  and  the  frame  number  requesti'd  T\  pe  in  the 
frame  number  (pressing  the  KFTUKN  key  afterwards).  Position  the  mouse  over  an 
end  point  of  the  new  frame  and  click  the  left  butliMi.  A  red  spot  will  appear  at  the 
selected  position  (the  x,y  coordinates  of  this  position  appear  on  the  screen)  Then 
move  the  mouse  to  the  other  end  of  the  frame  and  click  again.  Another  red  spot 
appears.  The  frame  is  now  defined  as  the  straight  line  between  these  tv\  o  point.  The 
sides  of  the  vessel  are  defined  by  straight  lines  between  two  adjacent  frames. 

To  add  further  frames  on  the  same  image  repeat  the  process,  bv  entering  the  frame 
number  and  clicking  on  the  frame  end  points.  For  frames  on  another  image,  press 
the  RETURN  key  when  the  next  frame  number  is  requested,  enter  "A  "  ti'  continue 
adding  (or  RETURN  to  stop)  and  enter  the  new  image  number  when  requested 
If  an  existing  frame  is  in  thi'  wrong  location  (that  is,  tin,'  moiisi'  u  as  positioned 
incorrectly)  then  this  frame  mav  be  redefined  bv  enlerim;  the  same  frame  number  and 
repositioning  the  mouse  to  click  o\  er  the  correct  frame  eiul  points 
Frames  may  be  entered  in  anvseqiience  as  they  will  be  automaticalh  sorted  into 
ascending  order. 


4.2  List  Frames 

The  selection  of  "List  Frame'  from  tlie  FRAMES  menu  will  display  a  list  ot  the 
existing  frames  in  the  compartment  data  file. 

The  image  number  is  shown  in  blue,  followed  by  the  list  of  frame  numbers  and  their 
corresponding  lower  and  upper  end  point  coordinates  on  that  image. 
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Clicking  the  mouse  will  display  the  next  page  of  frame  numbers  and  pressing  any 
keyboard  character  will  exit  "List  Frame". 


4.3  Delete  Frame 

An  existing  frame  can  be  totally  deleted  from  an  existing  compartment  data  file  by 
selecting  "Delete  Frame"  from  the  FRAMES  menu. 

Once  selected,  type  in  the  number  of  the  image  on  which  the  frame  is  located,  and 
then  the  frame  number.  You  will  be  alerted  to  any  errors.  The  deletion  has  been 
made  when  the  words  "Make  a  selection  from  the  menu"  appear  on  the  screen. 


5.  Rooms 

The  ROOMS  menu  allows  the  addition  and  alteration  c>f  compartments  within  the 
structure  of  the  vessel  created  using  the  FRAMES  menu. 

Compartments  are  placed  in  the  data  file  such  that  each  compartment  has  a 
particular  record  number.  .Anv  additions,  changes  or  listings  of  a  particular 
compartment  must  reference  the  relev  ant  record  number. 

Note  that  the  items  in  this  menu  should  be  ci>nsidered  i'nl\'  after  the  vessels  ma|or 
frames  have  been  defined  in  the  data  file,  by  using  the  FK.A.MHS  menu. 

Awkwardly  shaped  compartments  ma\’  be  defined  sev  eral  times  to  encompass  the 
shape  of  the  original.  Thus  a  long  corridor  may  have  several  sections,  on  adjacent 
images. 

The  following  subsections  describe  the  options  available  on  the  ROOMS  menu. 


5.2  Add  Room 

Select  "Add  Room"  from  the  menu  to  add  a  compartment  to  the  compartment  data 
file.  Compartment  details  are  entered  with  this  item,  with  a  line  b\-  line  prompt. 
Firstly,  you  are  prompted  for  the  citmpartment  label,  or  location  marking,  and  then 
the  compartment's  descripti\  e  name,  which  are  both  obtained  from  damage  control 
board  plans.  (Press  the  RETURN  key  to  complete  each  of  these  inputs.) 

A  description  of  the  compartment  contents  may  now  be  added.  The  contents  of  the 
previous  compartment  are  listed  as  the  default  contents.  You  may  ha\’e  an  empty 
compartment,  in  which  case  hit  "Y"  (yes),  i>r  wish  to  update  the  contents  by  hitting 
RETURN.  A  green  highlighted  a.-ea  defines  the  maximum  space  you  have  to  type  in. 
The  text  will  automatically  wrap  around  onto  the  next  line.  Alternatively,  the 
RETURN  key  will  start  a  new  line  tor  mi>re  text.  To  stop  adding  contents,  press  the 
RETURN  key  on  the  beginning  of  a  new  line. 

The  next  group  of  compartment  descriptors  are  (in  order)  flammability,  fuel  load, 
automatic  fire  fighting  factor  and  manual  fire  fighting  factor.  These  must  all  be 
calculated  from  prior  knowledge  of  the  ship  [5],  and  scaled  to  fit  the  range  1  to  255. 
Hitting  the  RETURN  key  without  a  number  will  set  the  previous  value  (shi>wn  in 
brackets)  to  be  the  new  value  for  this  compartment. 
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The  relative  ventilation  of  a  compartment  is  entered  as  a  numher  between  1  and  10. 
A  value  of  1  indicates  poor  ventilation  and  10  indicates  the  best  pc'ssihle  ventilation  in 
the  ship. 

The  manning  level'  for  action,  cruising  and  damage  stations  are  entered 
individually.  A  compartment  is  considered  occupied  if  the  compartment  is  manned 
for  more  than  ten  minutes  in  each  hour.  A  maximum  of  31  men  are  allowed  in  each 
compartment. 

Details  of  the  alarm  systems  are  included  next.  If  there  are  no  sensors  present,  enter 
"N" .  If  the  compartment  has  anv  alarm  systems,  enter  a  "Y"  (yes),  then  for  each 
sensor  type  -  flooding,  smoke  or  heat  -  enter  a  "Y"  or  a  "N"  if  present  or  not, 
respectively. 


Fif’ure  .3;  An  ulcoliicii  si’Cf/o/i  ot  the  liivitiiyc  control  bonrit  I'ctuwn  two  hnlkliciui^  i<  fhon’)i 
in  Mn).  In  3(/i)  the  pro^rnni  '^  npproxniiiition  ot /i;^ure  Mo)  ^hown  bo^eti  on  the  four 
comportment  locotion  points  <hou'n.  I'l^nre  Me)  >how<  on  incorrect  confi^nrotion  ot  It'cotion 
pmnt<  as  Oiljoinin^  toolb  ore  incorrect. 


Next,  the  user  is  prompte(.l  to  t\  pe  in  a  spoken  name  for  the  compartment,  which 
will  then  he  broadcast  (based  on  phonemes  1 1 1)  It  the  spoken  name  sounds 
unsatisfactory,  you  mav  re-enter  the  name  until  satisfied  with  the  result. 

The  last  part  of  adding  a  compartment  is  locating  that  compartment  The  '  home " 
image  of  the  vessel  will  be  displayed  on  the  screen.  Using  the  arrow  kevs  mo\  o  to  the 
image  on  which  the  compartment  should  be  U'cated  Click  the  left  mouse  button  on 
the  centre  of  the  compartment  to  define  that  compartment's  location. 

The  compartment  walls  are  now  considered  to  be  bi>unded  bv  the  locus  ot  points 
midwav  between  this  compartments'  location  point  and  the  locations  of  the 
surrounding  compartments,  as  shown  in  Figure  3  bulkheads  (defined  bv  the 
FRAMES  menu  option)  form  the  remaining  walls.  Figure  3(a)  depicts  a  typical  section 
of  a  vessel  betw'een  two  bulkheads.  F'igure  3(b)  depicts  an  approximation  ot 
Figure  3(a)  based  on  the  location  points  shown.  The  exact  shape  of  the  compartment 
is  not  critical.  I  low'ex  er  the  existance  ot  the  correct  common  w  alls  w  ith  ni'ighbourmg 
compartments  is  necessary  for  prediction  of  the  progress  of  a  fire  incident. 

Figure  3(c)  shows  how  an  incorrect  compartment  location  point  can  affect  the 
common  wall  position.  Therefore  consideration  of  the  compartment  center  point 
should  be  made.  After  clicking  on  the  U'cation  of  the  conipartment,  the  program  will 
display  the  w'alls  and  location  points  of  all  the  compartments  within  the  two 


biilkhe.ids  in  blue,  with  the  new  compartment  outlined  in  red.  If  the  walls  are  not 
shown  then  the  chosen  compartment  Icx'ation  is  outside  the  ship  as  defined  bv  the 
bulkheads  and  the  compartment  IcKation  should  be  re-entered. 

If  you  are  unsatisfied  with  the  positioning  of  the  compartment  location,  press  the 
'  C"  key  to  change  the  location  of  the  compartment.  The  COMP-EDIT  program 
displays  the  “home"  image  again.  Another  image  may  be  chosen  using  the  arrow 
keys.  Click  on  the  new  location. 

The  now  compartment  is  now  a  record  in  the  list  of  existing  compartments.  If  a 
compartment  had  preyiously  been  deleted,  then  the  new  compartment  will  take  the 
record  number  of  the  deleted  one. 

To  add  another  compartment,  press  the  "A"  key.  Otherwise,  hit  the  RETURN  key  to 
escape  back  to  the  menu. 

5.2  Edit  Room 

by  selecting  “Edit  Room  '  tii>in  the  menu  the  details  of  a  particular  compartment  ma\' 
be  changed  .A  prr'mpt  for  each  of  the  characteristics  listeil  in  .Add  Room  ill  be 
given.  To  lea\  e  a  detail  unchanged,  hit  the  RETURN  key.  To  edit  a  detail,  t\  pe  in  the 
required  alteraticm  The  old  entry  will  be  updated 

When  promped  about  alarms,  a  “Y“  or  “N"  must  be  entered  -  the  RETURN  key  will 
not  work.  Thus  alarm  information  must  be  re-entered,  even  if  these  details  were 
previously  correct. 

When  you  reach  the  option  to  adjust  the  compartment  location,  hitting  the 
RETURN  key  means  that  nti-adjusment  is  made.  Tvping  “'i'“  (yes)  will  display  the 
“home '  image.  To  alter  the  compartment  location,  choose  the  correct  image  (using  the 
arrow  keys),  and  click  the  mouse  on  the  required  location  The  i-ditted  compartment 
locafionivdl  be  shown  as  hordcred  in  red  lehi/e  the  immediate  neighbours  are 
bordered  in  blue. 

If  you  are  still  unsatisfied  with  the  positioning  of  the  compartment  location,  press 
the  “C"  key  to  change  the  location  of  the  compartment.  Move  to  the  correct  image, 
and  click  on  the  new  location. 

Press  RETURN  to  escape  back  to  the  menu,  or  press  “E"  to  edit  another 
compartment. 


5.3  Quick  List 

I5y  selecting  “Quick  List"  from  the  RfX'iMS  menu,  the  compartment  record  numbers 
are  listed  in  red,  with  the  corresponding  compartment  location  markings  and 
descriptive  names  listed  horizontally.  Clicking  the  mouse  will  continue  the  listing  of 
records,  while  RETURN  will  exit  back  to  the  menu. 

"Quick  List"  is  intended  for  quickly  finding  the  record  number  of  a  compartment 
that  you  wish  to  manipulate.  If  the  "Fix  Neighbour"  option  has  been  invoked  then 
compartments  are  listed  by  im.ige  number  -  aft  to  forward,  top  deck  to  bottom  deck. 
Compartments  added  or  editted  after  a  “Fix  Neighbour"  may  be  out  of  order. 
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5.4  List  a  Room 


This  option  in  the  ROOMS  menu  lists  all  the  details  of  a  single  ci>mpartment.  On 
selecting  "List  a  Room",  a  prompt  for  the  record  niimher  c>f  a  compartment  is  gi\  en. 
On  entering  the  record  number,  all  information  previouslv  stored  in  the  data  file 
about  that  compartment  (as  entered  in  the  "Add  Room"  option)  is  displayed. 

The  neighbours,  bulkhead  neighbours  and  vertical  neighbour  details  list  the  record 
numbers  of  the  surrounding  compartments.  These  refer  to,  respectively,  the 
adjoining  compartments  within  the  bulkhead  section  in  which  the  compartment 
occurs;  any  adjoining  compartments  in  the  next  bulkhead  section;  and  the 
compartments  directly  above  and  below.  The  neighbour  details  may  be  out-of-date  if 
compartments  have  been  added  or  editted  and  the  "Fix  Neighbour"  option  has  not 
been  implemented. 

Details  of  the  next  compartment  (by  record  number)  can  be  viewed  bv  clicking  the 
mouse.  Again,  hit  the  RETURN  ki'v  to  escape  to  the  menu 


5.5  Delete  Room 

A  compartment  mav  be  deleted  from  the  data  tile  b\  selecting  IX-lete  Room  '  Once 
the  compartment  record  number  is  typed  in.  the  compartment  name  and  locatiiin  arc 
listed  in  red,  as  a  check  that  this  is  the  c(>rrect  compartment.  You  have  the  choice  to 
delete  the  compartment  or  abort  the  deletu>n. 

Future  reference  to  a  deleted  compartment  will  gi\  e  a  "DELETED  ROOM"  message, 
unless  a  new  compartment  was  later  added,  in  which  case  the  lii'leteil  reconl  number 
would  be  used  Rir  the  new  compartment. 


5.6  Move  Room 

Selecting  "Move  Room"  allows  for  the  moving  of  compartments,  between  a  chosen 
pair  of  bulkheads.  That  is,  if  a  compartment  was  mis-located  it  may  be  relocated 
within  the  same  pair  of  bulkheads,  without  altering  the  compartment's  contents.  This 
option  is  used  to  correct  wall  positionings  such  as  .seen  in  Fgure  .'^(c).  For  drastic 
location  moves  around  the  vessel,  the  "Edit  Room  menu  option  is  required. 

After  selecting  "Move  Room  "  the  "home"  ship  image  is  ilisplaveil.  Use  the  arrow 
keys  to  obtain  the  ship  image  containing  the  location  ot  the  compartment  to  be 
moved.  Click  the  mouse  between  the  frames  that  are  on  either  side  of  the  current 
location  of  the  desired  compartment.  The  boundaries  around  all  the  compartments 
within  these  two  frames  will  be  shown  in  blue,  and  the  compartment  liKation  points 
will  be  shown  as  yellow  squares.  Click  on  the  new  compartment  location.  Note  that 
the  compartment  nearest  the  mouse  click  will  be  the  compartment  chosen  to  shift 
locations.  The  new  location  (and  new  shape)  of  the  compartment  will  be  outlined  in 
red,  with  the  immediate  neighbours  still  bordered  in  blue. 

To  move  a  compartment  out  of  its  original  boundaries  will  take  several  more 
operations,  so  "Edit  Room"  mav  be  quicker. 


14 


If  the  now  locntion  is  sntisfnctorv  then  hit  RETURN  to  obtnin  the  menu  ngnin. 
Otherwise,  pressing  the  letter  "M"  will  allow  vou  to  repent  the  "Move  Room  '  process 
on  any  compartment  on  anv  image,  although  the  previous  image  remains  on  the 
screen  until  the  arrow  kevs  are  used. 


5.7  Print  List 

"Print  List"  will  give  a  hard  copy  of  the  "Quick  List"  option.  That  is,  the  compartment 
location  marking  and  discriptive  name  of  each  compartment  are  listed  bv  record 
number.  To  have  the  compartments  sorted  by  image,  the  "Fix  Neighbours"  option 
needs  to  be  implemented  first. 

Having  selected  "Print  List",  you  are  given  an  opportunity  to  set  up  the  correct 
printer  by  using  the  Amiga  Preferences  (2]  before  continuing  (The  editor  disk  must  be 
placed  in  the  floppy  drive).  To  access  Amiga  Preferences,  hit  the  kevs  Left  Aiiii;^n  and 
N  at  the  same  time,  and  shrink  the  active  windmvs  I'O  the  VVt>i  kbench  screen  to  access 
thec(//ti)r  icon.  This  contains  the  Preferences  -  the  instructions  I't  which  are  in  the 
Amiga  Manual.  After  changing  the  printer  and  exiting  the  Preferences,  return  to  the 
COMP-EDIT  program  screen  bv  pushing  the  Workbench  screen  to  the  back  (click  on 
the  gadget  in  the  upper  right  hand  ci'iner  of  the  screen).  The  mouse  should  then  be 
clicked  once  in  the  program  screen,  and  anv  kev  pressed  to  start  printing.  .After  a 
short  delay,  a  request  for  the  shipdolo  disk  will  be  made.  Replace  the  iliif’dntii  disk  and 
return  to  the  COMP-EDIT  prrigram  screen  as  described  previcnislv.  The  program  will 
then  print  the  information,  and  will  indicate  completion  by  printing  Last  room  has 
been  printed"  on  the  screen. 


It  is  4  p.n.  and  the  Cook  has  Just  reported  a  fire  in  the 
Galley.  An  attest  was  Hade  to  fUht  this  fire  with  a 
foan  extinguisher  but  this  nerely  spread  burning  fat 
across  the  floor.  The  Halon  systen  appears  to  have  had 
no  effect  and  the  fire  is  still  burning. 


Click  House  To  Start 


Figure  4:  The  current  I’efsel.  iiiirifioii  ami  eiwinmiueiit  are  dei^cribed  on  thif  iicreeii  to  gtiv 
an  idea  of  what  lie^  ahead. 
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6.  Control 


Once  all  compartments  nave  been  defined  correctlv,  thev  must  be  linked  together  so 
that  each  compartment  is  referenced  to  all  its  neighbouring  compartments,  both 
vertically  and  horizontalK'.  Then  fire  scenarios  can  be  set  up  so  that  the  compartment 
data  file  and  the  associated  luitput  files  can  be  used  by  the  FIKKM.AID  program. 


6.1  New  Incident 

Selecting  "New  Incident"  allows  the  creation  of  one  or  more  fire  incidents  which  will 
be  used  bv  the  FIREMAID  program  to  initiate  fires.  (If  multiple  incidents  are  created 
then  the  FIREMAID  programs  will  randomly  select  one.) 

Note  that  the  "Fix  Neighbour"  menu  option  must  be  run  before  selecting  a  "New 
Incident"  if  any  updates  to  the  compartment  data  file  ha\  e  occurred 
Decide  how  many  incidents  to  create,  then  answer  the  listed  questions  tor  each 
incident,  hitting  the  RETURN  key  attereach  numeric  input. 

First,  enter  the  ship  state  (action  station,  cruising  or  alongside),  then  the  number  of 
compartments  iiwoK'ed  and  their  respective  record  numbers.  Finallv,  enter  a 
description  of  the  current  mission  r>f  the  vessel.  This  is  ti>  set  the  scene  at  the 
beginning  of  the  incident  for  the  user  of  the  FIREMAID  program.  .An  example 
mission  description  is  displayed  in  figure  4.  The  RETURN  key  will  start  a  new 
paaragraph.  To  end  the  descriptii>n,  liit  RETURN  at  the  start  i>f  a  paragraph. 

Repeat  this  process  for  each  incident.  Note  that  incidents  cannot  be  edited  nor  can 
incidents  be  appended  to  an  existing  list,  from  within  the  COMP-EDIT  program. 
Selecting  "New  Incident"  again  will  t>verwrite  existing  scenarios,  l  lowever,  the 
incidents  can  be  changed  iir  appended  using  an  AmigaDos  editor  12],  The  mission 
descriptions,  i/csc.n  where  n  refers  to  the  incident  number,  are  located  on  the  data  disk 
in  the  sdata  directory.  The  file  contains  firstly,  the  number  of 

incidents,  then,  for  each  incident,  the  number  of  compartments,  the  ship  state  and  the 
compartment  record  numbers  for  that  incident 


6.2  Fix  Neighbour 

Selecting  "Fix  Neighbour"  from  the  control  menu  is  a  necessar\'  part  of  constructing 
the  data  file  for  a  particular  ship.  Once  all  the  frames  and  compartments  have  been 
entered  and  all  modifications  are  made,  select  "Fix  Neighbour"  to  sort  the 
compartment  records  and  create  the  correct  connections  between  neighbouring 
compartment.  This  process  only  needs  to  be  run  once,  after  all  data  has  been  entered. 
Flowever,  if  further  compartments  are  deleted,  added  or  location  moved,  then  "Fix 
Neighbour"  should  be  selected  again  after  these  changes.  Also  note  that  because 
records  are  sorted,  existing  crirrpartments  may  be  assigned  new  record  numbers,  and 
therefore  the  incident  files  may  no  longer  produce  the  incidents  for  which  thev  were 
originally  designed.  In  this  case,  "New  Incident"  may  need  to  be  selected  again  to 
update  the  incident  files. 
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Records  nre  first  sorted  by  image  number,  then  neighbours  between  common 
bulkheads  are  found.  Next,  vertical  neighbours  on  adjacent  decks,  and  finally 
neighbours  between  different  bulkheads  are  obtained.  A  vessel  with  approximately 
200  compartments  defined  will  take  approximately  fifteen  minutes  to  complete  the 
process  of  linking  adjoining  compartments  together. 

The  sorting  of  decks  and  linking  of  neighbours  allows  FIREMAID  to  rapidly 
reference  a  compartment,  as  well  as  propogate  fire  in  a  realistic  manner  jo]. 


6.3  Quit 

To  exit  the  program  during  execution,  select  "Quit "  from  the  menu.  The  program  will 
exit  and  put  you  back  to  the  empty  Amiga  Workbench  screen. 
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